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SECTION 1 
DESCRIPTION 



The DILOG Model DQ226 is a single-board controller that interfaces 
one or two SMD-compatible disc drives to the following DEC* computers: 
LSI-11/23, LSI-11/23 PLUS, LSI-11/73, MICRO/PDP-11, and MICRO/VAX II. 
The controller is compatible with the DU driver in RT-11, RSX-11* 
RSTS/E, and MICRO/VMS operating systems. ' 

FEATURES 



The controller has the following features: 

Block mode capability 

22-bit addressing 

Software selectable DMA burst size of 1 to 8 words 

Universal Formatting from on-board components 

Error correction code of 11-bit bursts with a 56-bit 

nomial 

Automatic self-test 

Figure 1-1 is a simplified diagram of the computer system. 



poly- 



* DEC LSI-11, MICRO/PDP-11, MICRO/VAX II, RT-11, RSX, RSTS/E, MICRO/VMS, 
and DU Driver are registered trademarks of Digital Equipment Corpora- 
tions 
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LSI-11 Q BUS INTERFACE 
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parallel I/O bus (Q bus) of the computer. Data trans- listed in Table 1-1. 



fers are direct to memory via the DMA facility of 
the O bus* commands and «* - °^ f * a ara tivwioi* •%**%_ 
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Table 1-1. Controller/Q-Bus Interface Lines 



Bus Pin 


Mnemonic 


Controller 
Input/ 
Output 


Description 


AC2, AJ1, AM1, AT1, BJ1, 
BM1, BT1, BC2, CC2, CJ1, 
CM1, CT1, DC2, DJ1, DM1, 
DT1 


GND 





Signal Ground and DC return. 


AN1 


BDMRL 





Direct Memory Access (DMA) request from controller active 
low. 


AP1 


BHALT L 


N/A 


Stops program execution. Refresh and DMA is enabled. 
Console operation is enabled. 


AR1 


BREFL 


N/A 


Memory Refresh. 


BA1 


BDCOKH 


1 


DC power ok. All DC voltages are normal. 


BB1 


BPOKH 


N/A 


Primary power ok. When low activates power fail trap sequence. 


BN1 


BSACK L 





Select Acknowledge. Interlocked with BDMGO indicating 
controller is bus master in a DMA sequence. 


BR1 


BEVNT L 


O 


External Event Interrupt Request. Real Time Clock Control. 


AA2, BA2, BV1, CA2, DA2 


+ 5 


1 


+ 5 volt system power. 


AD2, BD2 


+ 12 


N/A 


+ 12 volt system power. 


AE2 


BDOUT L 


I/O 


Data Out. Valid data from bus master is on the bus. Interlocked 
with BRPLY. 


AF2 


BRPLY L 


i/0 


Repiy from slave to BDOUT or BDiN and during IAK. 


AH2 


BDINL 


I/O 


Data Input. Input transfer to master (states master is ready for 
data). Interlocked with BRPLY. 


AJ2 


BSYNC L 


I/O 


Synchronize: becomes active when master places address on 
bus; stays active during transfer. 


AK2 


BWTBTL 


I/O 


Write Byte: indicates output sequence to follow (DATO or 
DATOB) or marks byte address time during a DATOB. 


AA1, AB1, AL2, BP1 


BIRQ4L,5,6,7 





Interrupt Request. 


AM2 
AN2 
CM2 
CN2 


BiAKIi L 
BIAK10 L 
BIAK2I L 
BIAK20 L 


i 

O 
1 



Seriai interrupt Acknowledge input and outpui iines routed from 
Q-Bus, through devices, and back to processor to establish and 
interrupt priority chain. 


AT2 


BINIT L 


1 


Initialize. Clears devices on I/O bus. 


AU2, AV2, BE2, BF2, BH2, 
BH2, BK2, BL2, BM2, BN2, 
BP2, BR2, BS2, BT2, BU2, 
BV2 


BOALO L 
through 
BDAL15 L 


I/O 


Data/address lines, 0-15 


AR2 
AS2 
CR2 
CS2 


BDMG1I L 
BDMG10 L 
BDMG2I L 
BDMG20 L 


1 


1 


DMA Grant Input and Output. Serial DMA priority line from 
computer, through devices and back to computer. 


AP2 


BBS7L 


1 


Bank 7 Select. Asserted by bus master when address in upper 
4K bank is placed on the bus. 


AC1, AD1, BC1, BD1, BE1, 
BF1 


BOAL 16 L 
-BDAL 21 L 





Extended Address Bits 16-21 
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DISC INTERFACE 



Table 1-3, Controller To Drive I/O Interface— 



me controller interlaces one or two disc drives 
through 60- and 26-pin cables. If two drives are 
used, the 60-pin control cable ("A" cable) is daisy 
chained to drive and 1. The 26-pin cables ("B" 
cable) are connected separately from the controller 
to each drive. The maximum length of the 60-pin 
cable is 100 feet. The maximum length of the 26-pin 
cable is 50 feet. Table 1-2 lists the 60-pin interface 
signals, and Table 1-3 lists the 26-pin interface 
signals. 



Table 1-2. Controller To Drive I/O Interface— 
"A" Cable 





Pin Polarity 




Signal Name 


(Active) 






— 


+ 


Source 


DEVICE SELECT 


23 


53 


Controller 


DEVICE SELECT 1 


24 


54 


Controller 


DEVICE SELECT 2 


26 


56 


Controller 


DEVICE SELECT 3 


27 


57 


Controller 


SELECT ENABLE 


22 


52 


Controller 


SET CYLINDER TAG 


1 


31 


Controller 


SET HEAD TAG 


2 


32 


Controller 


CONTROL SELECT 


3 


33 


Controller 


BUS OUT 


4 


34 


Controller 


BUS OUT 1 


5 


35 


Controller 


BUS OUT 2 


6 


36 


Controller 


BUS OUT 3 


7 


37 


Controller 


BUS OUT 4 


8 


38 


Controller 


BUS OUT 5 


9 


39 


Controller 


BUS OUT 6 


10 


40 


Controller 


BUS OUT 7 


11 


41 


Controller 


BUS OUT 8 


12 


42 


Controller 


BUS OUT 9 


13 


43 


Controller 


BUS OUT 10 


30 


60 


Controller 


DEVICE ENABLE 


14 


44 


Controller 


INDEX 


18 


48 


Drive 


SECTOR MARK 


25 


55 


Drive 


FAULT 


15 


45 


Drive 


SEEK ERROR 


16 


46 


Drive 


ON CYLINDER 


17 


47 


Drive 


UNIT READY 


19 


49 


Drive 


WRITE PROTECTED 


28 


58 


Drive 


ADDRESS MARK 


20 


50 


Drive 


BUS-DUAL-PORT ONLY 


21 


51 


Drive 


SEQUENCE IN 


29 




Controller 


HOLD 


59 




Controller 





Pin Polarity 




Signal 


(Active) 






— 


+ 


Ground 


Source 


Ground 






1 




Servo Clock 


2 


14 




Drive 


Ground 






15 




Read Data 


3 


16 




Drive 


Ground 






4 




Read Clock 


5 


17 




Drive 


Ground 






18 




Write Clock 


6 


19 




Controller 


Ground 






7 




Write Data 


8 


20 




Controller 


Ground 






21 




Unit Selected 


22 


9 




Drive 


Seek End 


10 


23 




Drive 


Ground 






11 




Reserved for Index 


12 


24 






Ground 






25 




Reserved for Sector 


13 


26 







CONTROLLER SPECIFICATIONS* 

MECHANICAL - The DQ226 is com- 
pletely contained on one quad 
height module 26.4 cm (10.44 
in.) wide by 22.8 cm (8.88 in.) 
deep and plugs into one stand- 
ard Q-Bus quad slot. Base 
address is switch selectable. 
IP772150 
SA772152 

PRIORITY LEVEL - BR5 in etch; 
BR4, BR6 and BR7 by jumpers. 

INTERRUPT VECTOR ADDRESS - Pro- 
grammable by software. 

DMA BURST SIZE - Software select- 
able 1-8 words. 

DISC TRANSFER RATES - Up to and 
including 2.5 megabytes per 
second. 

DISC 1/0 - One 60 pin and 2 each 

Pfi nin nnnAiir**- r\y fHot- i»iKKAn 

cables. 

POWER - +5 volts at 4.7 amps, +12 
volts at 0.3 amps. 

ENVIRONMENT - Operating tempera- 
ture 50°F (10°C) to 104°F 
(40°C), humidity 10-9056 non- 
condensing. 

SHIPPING WEIGHT - 5 pounds in- 
cluding documentation and 
cables. 

MTTR - Less than 0.5 hours. 

* SPECIFICATIONS SUBJECT TO 
CHANGE WITHOUT NOTICE. 
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SECTION 2 
INSTALLATION 



The padded shipping carton contains the controller board, a 60-pin 
control cable to the drive, and if specified on the sales order, two op- 
tional 26-pin data cables to the drives. Inspect the controller board 
and its components and the cables for damage, 

NOTE 

If damage to the board, components on the board, or 
cables is noted, do not install. Immediately inform 
the carrier and Dilog. 

Figure 2-1 shows the locations of the switch and jumpers. 

Table 2-1 describes the switch and jumper settings. Some jumper 
connections may be etched or cut on the board and are referred to in the 
table as installed or removed. 
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Figure 2-1. Controller Configuration 
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CAUTION 

l-i _- _- -_ • — i- T ^ — J i. ^ 4- U ^ niin4-n_ . *U ^ » •! n 

stalling the controller board or cables. 

Check and set the switch and jumpers before installing the control- 
ler in the backplane. 

Table 2-1. Switch And Jumpers 

Switch SW1 

Location: Top edge of board 

Switch Setting Description 

SW1-1 ON With the RS232 cable connected between J4 

and the terminal RS232 connector, upon bus 
initialization, will enter on-board for- 
matter program. 

OFF Upon initialization, will enter emulation. 
Format from program on media. RS232 cable 
not required. 

SW1-2 NOT USED 

Jumper JP 1 

Location El 6 

Pin Setting Description 

1 to 2 Installed Factory use only 

2 to 3 Removed Factory use only 

4 to 5 Installed Boot Disabled 

5 to 6 Installed Boot Enabled 

7 to 8 Installed Boot Address 173000 

8 to 9 Installed Boot Address 175000 

10 to 11 & 

13 to 14 Installed Device Address 772150 

11 to 12 & 

13 to 14 Installed Device Address 772154 

10 to 11 & 

14 to 15 Installed Device Address 760334 

11 to 12 & 

14 to 15 Installed Device Address 760354 
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Table 2-1. Switch and Jumpers 
(continued) 



Jumper JP1 (continued) 
Location E16 
Pin_ 



16 to 17 




Setting 
Installed 



Installed 
Installed 



Description 



1 microsecond dwell time (time between 
DMA bursts) 

2 microseconds dwell time 
4 microseconds dwell time 



Priority Level 
BR4 
BR5 
BR6 
RR7 



1 to 2 
Installed 
Removed 
Installed 
Installed 



^ to 4 
Installed 
Installed 
Removed 
Installed 



5 to 4 
Installed 
Installed 
Installed 
Removed 



Jumper JP 3 
Location E10 



Pins 



Description 




2 to 3 
Installed 



Factory Set 



Location D3 

NOT USED - ALL JUMPERS REMOVED 

PRE-INSTALLATION CHECKS 

Before the controller is installed, it may be necessary to check 
the operating system for device addresses. The drives are designated 
DUX except in VAX/VMS where they are designated DUAX. The "X" repre- 
sents drive number. 
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It is important that all option slots between the processor and the 
disc controller be filled to ensure that the daisy-chained inter- 
rupt (BIAK) and DMA (BDMG) signals be complete to the controller 
slots. If there must be empty slots between the controller and any 
option board, the following backplane jumpers must be installed. 

FROM TO SIGNAL 

CO X NS CO X M2 BIAK1/L0 

CO X S2 CO X R2 BDMG1/L0 



I 1 



2. If two drives are to be installed, install the cable for the sec- 
ond drive into J3 on the controller before installing the control- 
ler into the backplane. Ensure pin 1 of the cable is matched with 
the triangle on the connector as indicated on Figure 2-1 . 

3. Ensure the controller is oriented with the components facing row 
one, the processor, and gently press both handles until the module 
connectors are firmly seated in the backplane, 

4. Disconnect the 10-pin cable connector from the DEC processor and 
install the connector into J4 on the controller. 

CAUTION 

Ensure the pins in the connector match those on the 
controller. One pin on the controller connector is 
removed. This pin matches the indicated connector 
pin on the cable. 

5. Install J1 and J2 into the connectors on the controller. Ensure 
pin 1 on each cable is matched with the triangle on each connector 
as indicated on Figure 2-1 . 

6. Connect J1 to the drive or drives if daisy-chained. Ensure the 
terminator is installed in the last drive. Connect the J2 cable to 
drive and J3 to drive 1 . Connect the RS232 cable to the ter- 
minal. 

7* Refer to the disc drive manual for operating instructions, and 
apply power to the drive(s) and the computer. 

8. Format the discs as described in Section 3- When formatting and 
testing are complete, remove power from the system. 

9. Disconnect the 10-pin cable connector from the controller and re- 
install the connector into the DEC processor. 

10. Apply power to the system and drive. The system is now ready to 
operate. 
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GROUNDING 

To prevent grounding problems, DILOG recommends standard ground 
braid be installed from the computer DC ground point to the disc drive 
DC ground point, if applicable, and also between disc drives at the DC 
ground points. 
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NOTE: Components on the board must be facing towards the Processor. 



Figure 2-3. MicroVAX II H9278 Backplane 
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SECTION 3 
OPERATION — FORMAT, DIAGNOSTICS, AND ERROR LOGGING 



The operation of the controller includes formatting the disc, run- 
ning DEC diagnostics, and checking the disc subsystem error log. For- 
matting is accomplished by the diagnostic utility program which presents 
a menu of drives to be formatted, or which prompts the operator for 
selecting drives not listed on the menu. The diagnostic utility program 
is on components on the controller. Subsystem error messages are also 
included in this section. 

DIAGNOSTIC UTILITY PROGRAM 

The program must be selected for a video terminal. Each display on 
screen will list the program name, the date, the revision and the model 
number. After the terminal selection, the drive manufacturer's name and 
model number of the selected drive will be listed or will state "not se- 
lected." The last line will always be a prompt. Defaults are enclosed 
in arrows <> and can be used by pressing the RETURN key. If a selection 
is not available, an error message will be displayed with an audible 
signal. The error message will be "Not a valid selection" or "No drive 
was selected for activity." Pressing the RETURN key will clear * the 
screen and redisplay the menu. 

Start-Up 

If the program is contained on components on the controller and J4 
is not connected to the terminal, perform the following: 

1. Ensure Switch SW1-1 is OFF and power is not applied to the 
terminal or the system. 

2. Connect the 10-pin cable on the DEC processor to J4 on the 
controller. 

3. Apply power to the terminal and system. 

4. Set SW1-1 ON. 

5. Ensure the CPU is halted. 
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The following will appear: 



DILOG Disk Utility Program 25/NOV/85 
Version: Beta Test Model: DQ226 



Terminal Selection Menu 



- Exit Program 

1 - Video Terminal in use 

2 - Printer Terminal in use 

Enter a selection then press RETURN key: 

Enter 1 if a video terminal is being used or 2 if a printer is be- 
ing used. Throughout the program a zero is used to exit the program or 
to exit to the previous major segment. 

Main Utility Menu 

After the title block, the drives selected and the Main Utility 
Menu will be displayed: 

Drive #0: (not selected) Drive #1: (not selected) 
Main Utility Menu 



- Exit Program 

1 - Exercise Menu for Selected Drive(s) 

2 - Format Selected Drive(s) 

3 - Run Controller Diagnostic 

4 - Disk Fixing Menu 

5 - Deselect Drive from Activity 

6 - Select drive #0 for Activity 

7 - Select drive #1 for Activity 

Enter a selection then press RETURN key: 
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If Items 1, 2, 4, or 5 are used, a drive must be selected first, 
either Item 6 or 7. If both drives have been selected, whatever activi- 
ty chosen (exercise, format, diagnostics) will occur to all drives; for 
example, multiple drives may be formatted with one command. 

Drive Selection and Deselection 

When drive #0 or drive #1 is selected for activity from the Main 
Utility Menu, the Drive Type Menu will be displayed. If one of the 
drives is not currently selected but has been previously formatted, the 
format parameters will be displayed. An example of the Drive Type Menu 
is as follows: 



DILOG Disk Utility Program 25/NOV/85 
Version: Beta Test Model: DQ226 



Drive #0: CDC 9715-515 Drive #1: (not selected) 

Drive #0 Type Menu 

< Previously Formatted: CDC 9715-515 > 

< Cylinders: 455 Heads: 24 Sectors: 48 Interlace: 3 > 



- Exit to Main Utilit v Menu 

1 - CDC 9715-515 * *2 - CDC 9762 

3 - CDC 9766 4 - Fujitsu M2312 

5 - Fujitsu M2321 6 - Fujitsu M2322 

7 - Fujitsu M2331 8 - Fujitsu M2333 

99 - Drive not listed above 

Enter a selection then press RETURN key: 

After the drive has been selected, a prompt will be issued for the 
desired interlace. A default will also be given: 

Drive #0: (not selected) Drive #1 (not selected) 

Host Resident Utility 



- OCTAL Device address 
(default: <172150>) 



Enter a selection then press RETURN key. 

To select drive 1 as it was previously formatted as drive 9715-515, 
enter 2. The program will return to the Main Utility Menu for format- 
ting the drive. To select any drive from the menu, enter the sequence 
number. To deselect a drive that is currently formatted, enter 5, "De- 
select Drive" from the Main Utility Menu. 
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The following is an example of the deselect prompt: 

Drive #0: (not selected) Drive #1: CDC 9762 
Deselect Drive from Activity 

- Exit to Main Utility Menu 

1 - Deselect Drive #1 

Enter a selection then press RETURN key: 

If the drive is not listed in the menu, enter 99. When a drive is 
not listed, the program will prompt for the parameters of that drive. 
These parameters may be obtained from the drive manufacturer's documen- 
tation. The first prompt will be the drive name. Drive #0, used here, 
is an example: 

Drive #0: (not selected) Drive #1: (not selected) 
User Defined Drive #0 



- Exit to Main Utility Menu 

- Enter Drive Name 

Enter a selection then press RETURN key: 

After the name is entered, the program will prompt for each param- 
eter. The name DILOG special is an example as are the values for param- 
eters. 

Drive #0: DILOG special Drive #1: (not selected) 

User Defined Drive #0 

Drive Name: DILOG special 

E - Exit to Main Utility Menu 
R - Reenter Drive Name 

- Enter Cylinders on Drive 

Enter a selection then press RETURN key: 300 

After each prompt, the program will display the value selected. 
After each value is selected, it will be posted at the top of the list 
under User Defined Drive. When all values are selected, the display 
will be similar to the following: 
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Drive #0: DILOG special Drive #1: (not selected) 
User Defined Drive #0 



Head Switch Time: 
Sector Interlace: 1 to 1 
Removable Media: NO 
Sectors per Head (Track): 32 
Heads per Cylinder: 5 
Cylinders on Drive: 300 
Drive Name: DILOG special 

- Exit to Main Utility Menu 

1 - Change user defined drive values 

2 - Save user defined drive values 

Enter a selection then press RETURN key: 

If parameters are to be changed, enter 1 repeatedly until the ap- 
propriate prompt appears. When all values have been entered, enter 2, 

The default value for head switch time is 0, and for the sector 
interlace the default value is 3 to 1, Head switch time is the number 

of Sectors t^SVP^S'*^ a< 5 nno hoad i «i pi er»t- r»oni r>p"l 1 v ci.HfrtWaH +■ n pnr\¥)nfx~ 

The zero default is the minimum time, less than 1 sector traversed dur- 
ing switching time. This value may be calculated from information in 
the drive manufacturers documentation. Interlacing is a technique used 
to match the transfer rate of the disc to the transfer rate of the com- 
puter. The interlace is the number of physical sectors traversed by the 
heads for every logical sector traversed; for example, with a 3 to 1 
interlace, data is transferred on every third physical sector during the 
first revolution, and three revolutions are required to transfer the en- 
tire track. A 1 to 1 interlace means one physical sector is traversed 
for every logical sector traversed; that is, the logical sectors as well 
as the physical sectors are contiguous. Other parameters listed above 
should be in the drive manufacturers documentation. 

Format Selected Drives 

After the drives have been selected or parameters entered for 
drives not on the menu, the Format Selected Drive option, Item 2 from 
the Main Utility Menu, may be entered. When this selection is made, an 
audible alarm — two beeps — will occur with the following caution: 

Format Selected Drive(s) 



*** *** *** WARNING *** *** *** 

If you continue, ALL data will be lost 

on drive #0. 
*** *x« *** *** s«* **# «*s *** *** *** 



u - Lxit to Main Utility Menu 
1 - Continue with format 

Enter a selection then press RETURN key: 1 
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If formatting continues, and a video screen is used, each of the 
partition formats below will list the current cylinder address and the 
following: 

. Write headers 

• Read headers (diagnostic partition only) 

• Write data 
. Read data 

If a printer is used, this information will be abbreviated. The 
display will resemble the following: 

Format Selected Drive(s) 

Press ESC (escape) key to pause test 

Drive #0: Short A-1 (example) 
diagnostic partition format 

*(see above) cyl: 
configuration partition format 

(see above) cyl: 
host partition format 

(see above) cyl: 
ret partition form a t 

(see above) cyl: 

Writing all 1792 blocks 

Record: 1792 

Verifying all 1792 blocks 

Record: 1792 

Summary: 

Total Read Errors: 

Total Revectors: 
Note: This Beta version does not perform revectoring 

Press RETURN key to continue. 

* The cylinder number is overwritten by the next line. 

Exercise Menu for Selected Drives 

To exercise the selected drives, enter 1 from the Main Utility 
Menu. The program will prompt for random or sequential order, number of 
passes- and report or revector bad sectors* The f^ro^ram will then dis= 
play the record number and the errors, as shown in the following ex- 
amples: 

Drive #0: (not selected) Drive #1: Short A-1 

Exercise Menu for Selected Drive(s) 



- Exit to Main Utility Menu 

1 - Read disk(s) in sequential order 

2 - Read disk(s) at random locations 

Enter a selection then press RETURN key: 1 
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Drive #0: (not selected) Drive #1: Short A-1 
Test! Read disk(s) in sequential order 



- Exit to Exercise Menu 

1 to 98 - Number of passes 
99 - Endless loop 



Enter a selection then press RETURN key: i 



Drive #0: (not selected) Drive #1: Short A-1 

Test: Read disk(s) in sequential order 
Number of Passes: 1 



- Exit to Exercise Menu 

1 - Report errors only 

2 - Report errors and revector bad sectors 

Enter a selection then press RETURN key: 1 



Drive #0: (not selected) Drive #1: Short A-1 

Test: Read disk(s) in sequential order 
Number of Passes: 1 
Report errors only 



Press ESC (escape) key to pause test 

Drive #1: Short A-1 Pass: 1 

Record: XXXX 

Total read errors: 

Test over. Press RETURN key to continue 

Run Controller Diagnostic 

This_optign_is„not implemented on Beta _Site_controllers , 

Disc Fixing Menu 

This option is not implemented on Beta Site controllers . 
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ERROR LOGGING 

Error messages for the disc subsystem are as follows: 

Description 



Error Message 


Number 





1 


2 


3 


4 


5 


6 


7 


8 


9 


10 


11 


12 


13 


14 


15 


16 


17 


18 


19 


20 


21 


22 



Undefined error 

Invalid Command 

Command Aborted 

Unit Offline 

Unit Available 

Media Format Error 

Write Protected 

Compare Error 

Data Error 

Host Buffer Access Error 

Controller Error 

Drive Error 

Invalid CPU Type 

Controller/drive contains unreasonable error rate 

Cylinder cannot be formatted 

RCT area cannot be formatted 

Drive not formatted 

Controller interrupt but no transition indicators 

Command ring transition interrupt 

Controller not online 

Command Ring Error 

Controller initialization failed 

Controller interrupt never received 
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SECTION 4 
PROGRAMMING 



The controller emulates the DEC* Model KDA50 Controller which is 
used in DEC subsystems such as RA60, RA80, and RUA81 . These subsys- 
tems differ from previous DEC subsystems, such as RL01 , RM80, and 
RP06, in the method of communication between the computer and the disc 
drives. 

Previously, the operating system requested an operation; the de- 
vice driver in the operating system converted the request to a logical 
format and passed this information to the controller; and the control- 
ler converted this information into a series of commands for the disc 
drive, which performed storage and retrieval functions. The device 
driver, the controller, and the disc drive were dependent on and 
unique to each other. With this type of communication, the functions 
of the disc drive appeared at the operating system level, and separate 
drivers were required for each disc drive model. 

With the KDA50 method of communication, the functions of the 
driver, the controller, and the disc drive are segmented; character- 
istics of the drive, such as disc geometry, no longer appear at the 
operating system level. Different types of drives, for example, fixed 
or removable, may be used. In effect, the device drivers are unbur- 
dened with the details of disc drive functions. The drivers are 
standardized, and the individual features of the drives are handled by 
the controller. 

To accomplish the KDA50 method, two levels of software were es= 
tablished: the lower level is the port driver, and the higher level 
is the class driver-server. The port driver is concerned with the 
communication link but not with the information passed on this link. 
The class driver-server is concerned with the type of drive (disc or 
tape) and the information passed by the link, but not with the link 
itself. Figure 4-1 illustrates the differences between these two 
methods of communication. Because the software is segmented, or or- 
ganized in modules, maintenance can be performed more easily; that is, 
~«e system can be changed or updated for new products. Also, communi- 
cation between systems can be more easily performed, networking, for 
example. 

j.118 sySuem uepends heavily on DMA; only two registers are used 
for establishing communication between the host and the controller. 
These are the Initialization And Polling (IP) register and the Stat- 
us/Address (SA) register. These two registers are described below 
under Initialization. After communication is established, the trans- 
port mechanism moves and monitors data and status by DMA operations. 
These operations are also described below. 
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Figure 4-1. Software, Previous And Current DEC Peripheral Systems 



INITIALIZATION PROCESS 

ister. Then the sequence goes through four steps using the SA regis- 
ter. For each step the host reads the SA then writes to SA. These 
steps are designated 1(A), KB), 2(A), ... 4(B). This process, the 
registers, and bits are shown and described on the following pages, 
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4= 
I 
4= 



INITIALIZATION 

INITIALIZATION AND POLLING REGISTER 

15 14 13 12 11 10 09 08 07 06 05 04 03 02 01 00 

I I I I I I I I I i 1 1 — I 1 1 1 — I 1 1 

| HOST | >| ANY -VALUE I 

I I I i I — I I i I I I 1 — I I I I I I -7- I 



BITS DESCRIPTION 

00-15 The Host writes any value to the controller to begin initialization. The bits have no 

meaning; the register is for access only. 



I 



STEP 1(A) 
STATUS ADDRESS REGISTER 

15 14 13 12 11 10 09 08 07 00 

I I I I I I I I I — I I - — ~ I 

| HOST |< IER | | I I 1 INV |QB |DI I RESERVED I 

I I I I I I I I I I I I 

BITS DESCRIPTION 

00-07 RESERVED. MUST BE . 

08 DIAGNOSTICS IMPLEMENTED - When set, this bit indicates that either wrap-around or purge 
and poll diagnostics are implemented. (See Section 3 for operation, diagnostics, and 
error logging.) When reset, this bit indicates the diagnostics are not implemented. 

09 Q-BUS - When set, this bit indicates 22-bit addressing is implemented. When reset, this 
bit indicates 18-bit addressing is implemented. 

10 N0NVECT0R - When set, this bit indicates that the interrupt vector is fixed in the con- 
troller hardware and the host cannot select tho vector. When reset, this bit indicates 
that the vector is not set in hardware and the host can select the vector; that is, posi- 
tion the controller where logically convenient. 

11-14 STEP NUMBER - Bit 11 must be set and bits 12, 13, and 14 must be reset during Step 1. 

4= 15 ERROR - When set, this bit indicates an error.. 



STEP KB) 
15 14 13 11 10 08 07 06 00 



| | | - | COMMAND | RESPONSE | | 

HOST I >| 1 IWR | RING LENGTH I RING LENGTH |IE | INTERRUPT VECTOR/4 



BITS DESCRIPTION 

00-06 INTERRUPT VECTOR - If bit 10 is reset in Step 1A, the host can place the vector in any po- 

sition. The controller takes the value from the host and multiplies the value by 4 for 
the interrupt vector. If bits 00 through 06 are zero, the host requests that interrupts 
be disabled. 



07 STEP INTERRUPT ENABLE - When this bit is set, the controller must interrupt the host at 

the completion of each step in initialization. If this bit is reset, the controller must 
not interrupt the host during initialization. 

08-10 RESPONSE RING LENGTH - These bits are the exponent (in octal) of the response ring length; 

for example, if all three bits are set, the value is 2 to the 7th power, or 128 32-bit 
words. 

11-13 COMMAND RING LENGTH - These bits are the exponent (in octal) of the command ring length; 

for example, if all three bits are set, the value is 2 to the 7th power, or 128 32-bit 
words. 

14 WRAP AROUND - If this bit is set, the host requests wrap-around diagnostics and writes to 
all 16 bits. The controller immediately echoes what the host writes. Wrap-around contin- 
ues until the host writes to the IP register, and initialization starts again. If this 
bit is reset, the host does not require wrap-around, and initialization proceeds to the 
next step. 

15 MUST BE 1 for this step only. 

NOTE: Step 1 must be completed within 10 seconds after the host writes to the SA register. 



I 



HOST |<- 
• I 



BITS 
00-0? 

08-10 
11-14 
15 



STEP 2(A) 

15 14 13 12 111 10 08 07 00 
| | — _ | .._- | 1 --.- | | I 

|ER I I I 1 I i PORT TYPE | ECHO BITS 15-8 OF STEP KB) | 

| | „- | .._- | | | | — - • I 

DESCRIPTION 

ECHO - These bits are an echo of bits 15-8 of Step KB). This is an integrity check of 
the controller by the host. Bits 7-0 are echoed in Step 3. 

PORT TYPE - These bits indicate the bus port. All three bits must be 0. 

STEP NUMBER - Bit 12 must be set and bits 11, 13, and 14 must be reset during Step 2. 

ERROR - When set during this step, this bit indicates an error. 



HOST 



STEP 2(B) 



15 



■>l 



RINGBASE LOW ADDRESS 



01 00 

. 1—. 

IPI 



4r 
I 

-3 



BITS 


1-15 



DESCRIPTION 

PURGE INTERRUPTS - When this bit is set, the host requests adapter purge interrupts. This 
bit is used for Unibus only. In all Q-bus systems, this bit must be 0. This bit is not 
required for the ringbase address, because DMA addresses begin and end on even boundaries. 

RINGBASE LOW ADDRESS - These bits represent the lower 16 bits of the bus starting address 
(Bit i3 understood by the controller and the host to be 0). 



NOTE: Step 2 must be completed within 10 seconds after the host writes to the SA register. 



I I 

I HOST |<- 
I I 

BITS 

00-07 



08-10 

11-14 
15 



STEP 3(A) 

15 14 13 12 11 10 08 07 00 

| | J | 1 — | - | — i 

|ER | I 1 I I I RESERVED I ECHO BITS 7-0 OF STEP 1(B) | 

| | | | | | | — — ! 

DESCRIPTION 

ECHO - These bits are an echo of bits 7-0 of Step 1(B). This is 'another integrity check 
of the controller by the host. 

RESERVED - MUST BE 0. 

NOTE: All Reserved bits must be . 

STEP NUMBER - Bit 13 must be set and bit3 11, 12, and 14 must be reset during Step 3. 

ERROR - When set during this step, this bit indicates an error. 



STEP 3(B) 



4r 

I 

oo 



HOST 



BITS 
0-14 

15 



15 14 
■>|PP I 



00 



RINGBASE HIGH ADDRESS 



DESCRIPTION 

RINGBASE HIGH ADDRESS - These bits represent the upper 15 bits of the bus address. Bits 1 
and are for Bits 17 and 16, and Bits 5-2 are for bits 21-18, respectively. 

PURGE AND POLL - When this bit is set, the host requests purge and poll tests. The con- 
troller ignores thi3 bit if the DI bit was reset in Step 1 (Bit 8 = 0). Both IP and SA 
registers are used for this sequence. The sequence is as follows: 

1. The host sets PP :s 1 and transmits Ringba3e High (Step 3(B)). 

2. The controller loads zeroes to the SA register. 

3. The host writes zeroes to the SA register, indicating the purge has been completed. 
The controller waits for the host to complete this action. 

4. The host reads (and discards) the IP register. This simulates the Start Polling com- 
mand. 

The host must complete this action within 100 milliseconds. 

5. When the controller finishes this test, the memory area is filled with zeroes by DMA, 
and the SA register posts the transition to Step 4. The host can then check the area 
to ensure zeroes are in that area, and areas above and below are not affected. 



The controller must complete DMA tests within 10 seconds from the start of Step 3(B). 



I HOST |<- 



BITS 
0-7 

8-10 

11-14 

15 



15 14 II 3 12 11 10 



STEP 4(A) 

08 or 



00 



ER I 1 I I | 
| | J | |— . 



RESERVED I CONTROLLER MICROCODE VERSION | 



DESCRIPTION 

CONTROLLER MICROCODE VERSION - These bits tell the host the revision level of the micro- 
code. The host ensures this is the latest version and stores this number. 

RESERVED 

STEP NUMBER - Bit 14 must be set and bits 11, 12, and 13 must be reset during Step 4. 

ERROR - When set during this step, this bit indicates an error. 



VD 



I HOST !• 



BITS 


1 
2-7 



15 



STEP 4(B) 
08 07 



02 01 00 



■>l 



I 1 



RESERVED 



BURST 
DESCRIPTION 



ILF IGO I 
I 



GO - When this bit is set, the host tells the controller that all integrity checks are 
complete and that the initialization sequence is complete., The controller should then go 
online. 

LAST FAIL - When set, this bit requests the controller to send a packet describing the 
last failure. This is used in error logging. 

BURST - These bits specify the number of longwords (32 bits), less one, that the host 
allows per DMA transfer. This permits setting each controller to a different burst size, 
in effect, tuning the bandwidth, or giving one controller more bursts no matter what the 
controller's priority is. For example, during tape backup, the host may allow the tape 
controller a larger burst size to permit efficient streaming. 
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RESERVED 



PORT TRANSPORT MECHANISM - COMMAND AND RESPONSE RINGS 

If fo*« fha lMl f •! ol l»»of < a« nw r\*\r\ a a 4-Ua i-\am 4- W *•■;.. ^ _ 4. w. _ » J. T _.. 

passes messages between the host class driver and the controller class 
server. The transport mechanism is based upon two FIFO's: one for 
messages to the controller, called commands; and one for messages from 
the controller ? called responses. The FIFO's are mechanized as circu= 
lar buffers, called rings. The rings are contiguous blocks of memory 
which are addresses, essentially pointers, to the command and response 
message packets. Command and response packets are not necessarily 
contiguous. 

Commands and responses require three DMA operations each. Per- 
forming an operation does not necessarily require DMA. The sequence 
is as follows: 

A. Command 

1. Get Descriptor (DMA) 

2. Fetch Packet (DMA) 

3. Update Descriptor (DMA) 

B. Operation (not necessarily DMA) 

C. Response 

1. Get Descriptor (DMA) 

2. Deposit Response (DMA) 

3. Update Descriptor (DMA) 

The sequence for a command packet transport operation as listed 
above is as follows: D.the controller obtains a packet address from 
a descriptor in the ring, 2) a second DMA operation moves the packet 
into the controller, and 3) a third DMA operation updates the descrip- 
tor to indicate the packet has been removed. 

The area in the buffer, the communications area, is shown in Fig- 
ure 4-2. The area encloses a header and the descriptor. As shown in 
the illustrations, the descriptors are layered in 32-bit words, called 
longwords. 

The highest-order bit (bit 3D in the descriptor is the ownership 
bit. When the bit is set, the descriptor and buffer are owned by the 
controller. When the bit is reset, the descriptor and buffer are 
owned by the host. When the system is idle, the command descriptors 
are owned by the host (bit 31 = 0) , and the response descriptors are 
owned by the controller (bit 31 = 1). When the host places the com- 
mand into the command buffer, the host turns ownership over to the 
controller by setting bit 31 to 1 . When the controller polls the ring 
buffer and finds bit 31 is 1 , the controller removes the packet from 
the buffer and returns the buffer to the host by setting bit 31 to 0. 
When the host finds bit 31 is cleared, the process is repeated. 
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OFFSET 
OPTIONAL 



15 



8 7 



-8 
-6 
-4 
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+2 
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+6 



RESERVED 
j 1 

ADAPT CHAN | RESERVED | 



CMD RING TRANSITION INT | 



RESP RING TRANSITION INT| 
1 



RESPONSE 
DESCRIPTOR 



l^ HEADER (FLAGS) 

Adapter Channel: 

(VAX 780 Systems) when the controller requests 
HEADER an adapter purge, the adapter channel number is 

specified in the high byte. 
Command Ring Transition Interrupt: 

Command ring transition — full-to-not-full. 
Response Ring Transition Interrupt: 

Response ring transition — empty-to-not-empty. 



RESPONSE DESCRIPTOR RING 

(SIZE DETERMINED IN INITIALIZATION STEP 1 (B)) 
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COMMAND DESCRIPTOR 
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n = Response Ring Size 
m = Command Ring Size 
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COMMAND AND RESPONSE DESCRIPTOR 
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BIT(S) DESCRIPTION 

1-15 L = lowest bits of address in all systems, 

Bit is because addresses are 
always on a boundary. 

16-17 U = Extended Unibus address. 

18-21 Q = Bits 18-21 of Q-bus address. 

22-29 Reserved 

30 Fa Flag bit (see below). 

31 = Ownership (see below). 



31 


30 







I Descriptor and buffer owned by host. 


1 


- 


! Descriptor and buffer owned by controller* 


1 





Descriptor owned by controller, and host is not re- 
! questing ring transition interrupt. 


1 


1 


Descriptor owned by controller, and host is requesting 
ring transition interrupt. 



Figure 4-2. Communications Area 
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A flag bit (bit 30) tells the controller whether to interrupt the 
host for a transition from full- to-not-full for a command and empty- 
to-not-emoty for a response s If the fla** bit- is not- set when the host 
passed ownership to the controller, the host is not requesting a ring 
transition interrupt. The controller always sets the flag bit when 
returning the descriptor to the host. Normally, the host does not 
clear the flag bit, and by default, ring transition interrupts are 
enabled. 

The controller knows the number of descriptors in the buffer from 
initialization, Step KB). The controller multiplies this number by 4 
(bytes/longword) and notes the beginning ringbase address of the com- 
mand descriptor ring. From the number of descriptors specified in 
KB), the controller calculates the size of the communications area. 
The controller then sets up pointers for the size of command and re- 
sponse descriptors. In a well-ordered, smoothly-running system, there 
should be few transition interrupts, and a relatively small number of 
command and response descriptors waiting to be processed. For every 
command descriptor there is a response descriptor. There are addi- 
tional response descriptors for activity such as credit notification 
and error logs. A single command descriptor could evoke two or three 
response descriptors. 
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ENVELOPE AND MESSAGE PACKET - PORT AND CLASS 



As orevious^v stated- the desc^i^to^s n o , 'nt to buffers- qt* 4-«v+- = 
The descriptors are the concern of the port drivers. The data messages 
or text are the concern of the class drivers; however, the message en- 
velope contains four bytes of data which are the concern of the communi- 
cation link, the port driver* The descriptor points to the bytes Text+Q, 
where the message begins. But the DMA operation begins at Offset-4, 
starting with the message length. The message envelope is shown in 
Figure 4-3. 



The four bytes of data include the message length, the communica- 
tion identifier, the message type, and the credits. The first two bytes 
specify the message length in bytes. The host sets the buffers accord- 
ing to size. Command length is set beginning with Text + according to 
the number of bytes transmitted to the controller. Response length also 
begins with Text + and the minimum length is 60 bytes decimal (74 oc- 
tal). If the message is longer than 60 bytes, the controller segments 
the message into as many buffers as required. For example, an error log 
packet may be 384 bytes which requires 7 separate transmissions from the 
controller to the host. The controller also modifies the length to the 
actual size when the length is less than 60 bytes. 
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Figure 4-3. Envelope And Message Packet 
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The connection identifier is 8 bits. These bits identify the 
destination server within the controllers For example disc devices 
are 0? and the diagnostic utility orosraro has a connection identifier 
of 2; maintenance is 255. 

The messages type, bits 4-7, are as follows: 

MESSAGE TYPE 

NUMBER NAME AND DESCRIPTION 



Sequential Message - The next message in the 
queue. The message length and credit notification 
fields are required, 

1 Datagram - A low priority message, usually an 
error log packet that the recipient may not have 
been expecting and may not have a buffer available 
for. The message length field is valid, and the 
credit field is zero, 

2 Credit Notification - For credit notification, the 
message length field is zero, 

3-14 RESERVED 

15 MAINTENANCE 

The credit system is a control mechanism for the controllers 
command buffers. The controller passes a count to let the host know 
how many sequential messages can be accepted. When beginning the 
process, the host assumes the controller can queue only one command, 
and the host sets the credit counter to one, gives the controller the 
command, and decrements the credit counter to zero. If the host f s 
credit counter goes to zero, commands to the controller will not be 
issued. When the controller finishes processing the command, the con- 
troller notifies the host how many commands can now be processed by 
returning credits in the response. After the first command is pro- 
cessed, the controller returns the credits to the host in multiples of 
15. For example, if a controller can queue and process 28 commands, 
the credit field in the first response will be 15. The host may then 
issue a second command (bringing the credits down to 14) and in the 
second response, the credits will be 14 (13 for those remaining of the 
28 and one for the second command issued) , 

CONTROL MESSAGE FORMATS - CLASS 

The Control Message Formats are the concern of the class driver- 
servers. This information makes the disc perform read and write op- 
erations. This information begins with the message bytes in the mes- 
sage envelope. The command reference number is MB0-MB3 in the mes- 
sage envelope (Figure 4-3) . The Control Message Formats are shown and 
described in Figure 4-4. 
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Header 
(12 Bytes) 



BUFFER DESCRIPTOR 
(UNDEFINED FOR RESPONSE) 



LOGICAL BLOCK NUMBER 



I J 



2i 



OFFSET 28 - END MESSAGE (RESPONSE) 
FIRST BAD BLOCK 

OFFSET 8 - COMMAND MESSAGES 
MODIFIERS 



RSVD | OPCODE 



OFFSET 8 - END MESSAGES (RESPONSE) 




STATUS 



FLAGS 



STATUS CODE AND SUBCODE (RESPONSE) 



Parameters— 
20 Bytes/ 
v Transfer CMD 
12 Bytes ) (48 Bytes 

max* length 
depends on 
Opcode ) 



I 4 Bytes 



s 



32 Bytes 60 Bytes max 




Refer to Table 4-1 




Refer to Table 4-2 




Refer to Table 4-3 




Refer to Table 4-4 



Refer to Table 4-5 



Figure 4-4. Control Message Formats-Command And Response 
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Header 

The first four b v tes contain the oonnnsn^ rgf^rpn' - "^ m'mh^?* ^ up^ = 
MB3) in the message envelope). This number is assigned by the host 
when commands are queued and must be unique for every command within 
the cntroller. 

The unit number field is 16 bits, permitting divisions of more 
than 65,000 » Each unit that can be addressed may be a different size. 
Unit numbers need not be contiguous on a controller. If multiple con- 
trollers are used, each number in the system must be unique. Dividing 
the unit numbers in this manner is advantageous for multi-controller 
systems. 

The Opcode byte, when transmitted to the controller, describes a 
command or operation. When transmitted to the host, these bits are 
end codes and they specify End or other messages. Opcodes are listed 
in Table 4-1 . 

Modifiers or Status bytes are related to commands and are listed 
with each command. Modifiers used with many commands are Compare, 
Express Request, Force Error, Suppress Error Correction, and Suppress 
Error Recovery. Modifiers are listed in Table 4-2. Flags are listed 
in Table 4-3. Status bytes are for response messages and are further 
divided into codes and subcodes. Codes listed in Table 4-4 are five 
bits and are common to all commands of this emulation. Subcodes, 
listed in Table 4-5, are unique to each command. The flag byte of a 
response message reports conditions about the command but not neces- 
sarily related to the successful execution. The flags in this field 
identify Bad Block Reported, which identifies to the host a block to 
be replaced in the "First Bad Block" area; Bad Block Unreported, which 
is set if more than one bad block is identified; and Error Log Gen- 
erated, which is an error log message related to that command. Other 
formats and bytes are listed and described under "Command Types." 

Transfer Messages - Parameters 

The first 12 bytes, referred to as the Header in Figure 4-4, are 
common to all systems. The next 20 bytes, referred to as Parameters, 
include three items that all DMA messages have: byte count, buffer 
descriptors, and logical block number. 

For commands, the byte count is the desired number of bytes to be 
transferred. For responses, the byte count is the number actually 
transferred. In this system, the byte count is the number actually 
transferred, as opposed to the 1 ? s complement in previous systems. 

The buffer descriptor may contain a 96-bit address. Currently, 
there are 18 bits used for Unibus addresses and 22 bits for Q-bus 
addresses. This address is the starting address in memory where the 
DMA transfer begins. 
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The logical block number describes the starting address on the 
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troller. In the response message, the logical block number is called 
the First Bad Block, which is an error field. The controller uses 
this field to report the bad block to the host and contains valid data 
only when the Bad Block Reported flag is set. 

End Messages 

The End Message format is as shown in Figure 4-4. The area of 
the buffer descriptor is undefined, the modifier bytes are as shown, 
and the logical block number is the First Bad Block. The Opcode in 
commands contains a flag that specifies the field as Opcode (commands 
to the controller), End Code (status transmitted to the host), and 
Attention Codes (End Codes that have no corresponding Opcode, essen- 
tially response packets that were not solicited by a command packet). 
An End Code is a returned Opcode with bit 7=1. 
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Table 4-1. 


Opcodes 


07 
' _» ! 


I -. 


... ! — 


._ ! ___ ! 


00 


! 1 I 
j i i 


1 
1 — 


I 


I I 


I I 
.-I —-I 


\ ' l — 








1 y 






— SS 






s ; 




Ml 






= OPCODE < — ! 










1 = ENDCODE j 


0- 


-7 


= Immediate Command . 


I 


8- 


-F 


s Sequential Command 


= CMD < 


10-14 


= Nonsequential Command, DMA not required 


1 = ATTN MSG 


20-3F 


= Nonsequential Command, DMA required 




40-42 


= Attention Message 






VALUE 


VALUE 


COMMAND 


OCTAL 
01 


HEX 
01 


COMMAND OCTAL HEX 


Abort 


Set Unit Charac- 


Access 




20 


10 


teristics 12 0A 


Available 




10 


08 


Write 42 22 


Compare Host Data 




40 


20 


Access Path 


Determine Access Path 




13 


0B 


(Attention Msg.) 102 42 


Erase 




22 


12 


Available 


Get Command Status 




02 


02 


(Attention Msg.) 100 40 


Get Unit Status 




03 


03 


Duplicate Unit Number 


Online 




11 


09 


(Attention Msg.) 101 41 


Read 




41 


21 


End Message (Flag) 200 80 


Replace 




24 


14 


Serious Exception 


Set Controller 








End Message 7 7 


Characteristics 




04 


04 








Tabl 


e 4-2. 


Modifiers 


31 

I — 
I 








16 


i 
i 






tti T nn 

VALiUC. 


COMMAND MODIFIRR 


OCTAL 


HEX COMMAND MODIFIED 


Compare 






40000 


4000 Generic 


Express Request 






100000 


8000 Generic 


Force Error 






10000 


1000 Generic 


Suppress Error Correction 




1000 


200 Generic 


Suppress Error Recovery 






400 


100 Generic 


All Class Drivers 






2 


2 Available 


Spin-Down 






1 


1 Available 


Next Unit 






1 


1 Get Unit Status 


Allow Self Destruction 






1 


1 Online 


Ignore Media Format Error 




2 


2 Online 


Enable Set Write Protect 




4 


4 Online and Set Unit 










Characteristics 


Primary Replacement Block 




1 


1 Replace 
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Table 4-3. Flags 



T Y P E 



End Message 
End Message 
End Message 



FLAQ 



Bad Block Reported 
Bad Block Unreported 
Error Log Generated 



-VALUE 



QCTAl 



100 
40 



ML 

80 
40 
20 



Table 4-4. Status Codes 



04 



00 



STATUS 



VALUE 



Success 

Invalid Command 

Command Aborted 

Unit Offline 

Unit Available 

Media Format Error 

Write Protected 

Compare Error 

Data Error 

Host Buffer Access Error 

Controller Error 

Drive Error 

Message From Internal Diagnostic 



OCTAL 


HEX 





A 


I 


1 


2 


2 


3 


3 


4 


4 


5 


5 


6 


6 


7 


7 


10 


8 


11 


9 


12 


A 


13 


B 


37 


1F 
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Table 4-5. Subcodes 



1R 



nc; nn 



nn 



SUBCODE 



CODE { 



CODE 


SUBCODE 


[SUBCODE 
I VALUE 
i HEX 


ONLY 


wJJij OH £>w,DwvsD£» 

VALUE 
OCTAL HEX 


Success j 


Normal 


: o 












Spin-Down Ignored 


i 1 




40 


20 




Still Connected 


i 2 




100 


40 




Duplicate Unit Number 


j 4 




200 


80 




Already Online 


i 8 




400 


100 




Still Online 


i 16 




1000 


200 


Invalid 
Command 


Invalid Message Length 


I o 




1 


1 


Specific Offset of the field 
in the Command Packet that is 
invalid 

Unit Unknown Or Online 
To Another Controller 


i The field of 
i command is i 
I 0ffset*256.n 
I Status Code 

! 


*fset for the 
lsed as follows: 
hlnvalid Command 


Unit 
Offline 


3 


3 




No Volume Mounted Or Drive 
Disabled By Switch 


! 1 




43 


23 




Unit Inoperative 


! 2 




103 


43 




Duplicate Unit Number 


i 4 




203 


83 




Unit Disabled By Customer 
Service Or Diagnostic 


j 8 




403 


103 


Media 

Format 

Error 


! EDC Error 


i 1 




45 


25 


I Invalid Header 


i 2 




105 


45 




I Data Sync Time-Out 


i 3 




145 


65 




! Disc Not Formatted With 
I 512 Byte Sectors 


i 5 




245 


A5 




! Disc Not Formatted 


"l 6 




305 


C5 




! Uncorrectable Error 


I 7 




! 345 


E5 
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Table 4-5. Subcodes 

\ '•'W »• «» J. »4 Wt€\4 / 



CODE 

Write 
Protect 


1 SUBCODE 

I Unit Hardware Write Protected 


I SUBCODE ONLY! 
j VALUE - j 
! HEX { 

I 256 """ { 


CODE & SUBCODE 
VALUE 
OCTAL HEX 

20006 2006 




j Unit Software Write Protected 


I 128 | 


10006 


1006 


Data 
Error 


I Sector Written With Force 
j Error Modifier 


I I 
i j 


10 


8 




1 Header Compare Error 


i 2 | 
i 3 I 


110 
105 


48 




1 Data Sync Time-Out 


68 




I Uncorrectable ECC Error 


i 7 I 


350 


E8 




j 1-Symbol ECC Error 


! 8 | 


410 


108 




i 2-Symbol ECC Error 


i 9 j 


450 


128 




I 3-Symbol ECC Error 


10 i 


510 


148 




I 4-Symbol ECC Error 


11 I 


550 


168 




! 5-Symbol ECC Error 


12 i 


610 


188 




I 6-Syrabol ECC Error j 


13 j 


650 


1A8 




j 7-Symbol ECC Error j 


14 { 


710 


1C8 




I 8-Symbol ECC Error J 


15 i 


750 


1E8 


Host 
Buffer 


! Odd Transfer Address } 


1 i 


41 


29 


aCCcSS 

Error 


i uaa t$yte uount { 


2 S 


73 


49 




I Nonexistent Memory { 


3 j 


105 


69 




i nosu Memory rarity Error J 


4 i 


137 


89 
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COMMAND TYPES AND QUEUING 
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Envelope) is transmitted to the controller for queuing. The Unit 
Number field specifies which queue (for which disc drive) the command 
is placed in. A Command Packet generates a Response Packet. If a 
command packet does not generate a response packet during a set con- 
troller time-out interrupt, a command time-out occurred. 

Another time-out, the host access time-out, may also occur. The 
maximum interval for this time-out is approximately two minutes, and 
is set by the host. The host can override, or disable, this time-out 
(counter set to 0)i and by doing so, the host tells the controller not 
to go offline. This feature is useful for slower systems. When a 
controller is brought online, the time-out interval is automatically 
set for 60 seconds. 

Three categories of commands establish priorities for the con- 
troller to queue the command packet. They are immediate, sequential, 
and nonsequential. Immediate commands, such as ABORT and GET STATUS, 
are to be processed before other commands in the queue. Sequential 
commands relate to operations performed on the drive, such as spin- 
down the drive and modify write protect. Nonsequential commands, such 
as READ and WRITE, may be re-ordered by the controller at any time. A 
sequential command places a boundary, or barrier, on the queue. If 
nonsequential commands are received after a sequential command, a new 
queue is established; all nonsequential commands in the old queue 
should be executed before the sequential command is executed. Non- 
sequential commands also contain modifiers to re-order the queue; for 
example, an express modifier may place a command at the beginning of 
other nonsequential commands in the queue. Nonsequential commands are 
queued for the most efficient use of the drive. 

Commands, categories, modifiers, end messages, and status are 
described below. 
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Abort 






Command and Response Descr lotion i The 

refers to the command reference number of the command to be aborted. 
The unit number must be the same as that unit in the command to be 
aborted. The format is as follows: 





COMMAND 

31 16 15 00 
| j 

i COMMAND REFERENCE NUMBER 

! j 

I RESERVED | UNIT NUMBER 
| , 

MODIFIERS j RSVD | OPCODE 
j | j 

I OUTSTANDING REFERENCE NUMBER 
i ....... { 



RESPONSE-END MESSAGE 



! STATUS 



FLAGS {END CODE I 



Opcode: 01 (Octal and 

Hex) 
Category: Immediate 
Allowable Modifications: 

None 



Category: Success 
(Subcode Normal) 



If the command had been processed before it could be aborted, no 
error is posted. The controller always responds with "success" and 
"normal" to this command. The host checks the aborted command's re- 
sponse end code to determine if the command was aborted or processed. 
The original command may be processed with "abort" or "success" re- 
turned in the end code. The controller's only restriction is that the 
command to be aborted and the Abort command itself must be processed 
within one time-out interval. 



4-23 



Access 
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Read Check, The buffer descriptor is not relevant because there is no 
DMA to memory. Data from the unit is read by the controller, checked 
for errors, and discarded. The format is as follows: 




T" 




COMMAND 
16 15 



00 



COMMAND REFERENCE NUMBER 



RESERVED 



UNIT FIELD 



MODIFIERS 



RSVD 



j OPCODE 



BYTE COUNT 
i 



RESERVED 



^ 



n^ 



LOGICAL BLOCK NUMBER 



RESPONSE 



FIRST BAD BLOCK 



STATUS 



FLAGS iENDCODE 



Opcode: 20 (Octal); 10 
(Hex) 

Allowable Modifiers: 

Express Request - Re- 
quests controller to 
place- the command 
ahead of other nonse- 
quential commands in 
the queue. 

Suppress Error Correc- 
tion - Does not cor- 
rect errors but allows 
retries. 

Suppress Error Recov- 
ery - Requests that no 
steps be taken to re- 
cover data. 



Status 

Success (Normal) - Command completed, no errors. 

Success (Duplicate Unit Number) - Controller recognizes the same 
unit number on more than one drive. 

Invalid Command - Controller cannot process the command because 
some field in the command packet is invalid for the control- 
ler or that unit; for example, the logical block number may 
be too large. 
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Access (continued) 

Command Aborted — Controller succeeded in aborting the command = 
Unit Offline - Drive cannot be brought up or does not exist. 
Unit Available - Drive is not currently online. 
Data Error - Data read from the disc contains an error. 
Controller Error - Controller has failed a self-test or internal 

consistency check. 
Drive Error - Drive error sensed by the controller. 
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Available 
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changing unit states. Only the header portion of the format is used. 
In multi-port systems, this command makes the drive available to 
another controller. 




COMMAND 
16 15 



00 



COMMAND REFERENCE NUMBER 
J 

RESERVED | UNIT NUMBER 

I 



MODIFIERS 



RSVD j OPCODE 



RESPONSE 



STATUS 



FLAGS SENDCODE 



Opcode: 10 (Octal), 08 
(Hex) 

Category: Sequential 

Allowable Modifier: 

Spin-Down - Request 
that the drive be spun 
down. 



Status: 



Success (Normal) — Drive is available. 

Success (Duplicate Unit Number) - Controller recognizes the same 
unit number on more than one drive. 

Success (Spin-Down Ignored) - Drive is available and left spin- 
ning. 

Success (Still Connected) - Always set if Spin-Down-Ignored is 
set. 

Command Aborted - Controller succeeded in aborting the command. 

Unit Offline - Drive cannot be brought up or does not exist. 

Controller Error - Controller has failed a self-test or internal 
consistency check. 

Drive Error - Drive error sensed by the controller. 
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Compare Host Data 






Write Check commands in previous systems. Data from the disc is read 
and compared with data in host memory. 



31 



COMMAND 
16 15 



00 




COMMAND REFEJ 


IENCE NUMBER 


RESERVED 


UNIT 


NUMBER 


MODIFIERS 


— — — 
RSVD 


OPCODE 



BYTE COUNT 



BUFFER DESCRIPTOR 



LOGICAL BLOCK NUMBER 



RESPONSE 



FIRST BAD BLOCK 



STATUS 



FLAGS 



ENDCODE 



Opcode: 
Hex 



40 (Octal), 20 



Category: Nonsequential 

Allowable Modifiers: 

Express Request - Re- 
quests controller to 
place the command 
ahead of other nonse- 
quential commands in 
the queue. 

Suppress Error Correc- 
tion - Does not cor- 
rect the error but 
allows retries 

Suppress Error Recov= 
ery - Requests that no 
steps be taken to re- 
cover data. 



Status 

Success (Normal) - Command completed, no errors. 

Success (Duplicate Unit Number) - Controller recognizes the same 
unit number on more than one drive. 

Invalid Command - Controller cannot process the command because 
some field in the command packet is invalid for the control- 
ler or that unit; for example, the logical block number may 
be too large. 

Command Aborted - Controller succeeded in aborting the command. 

Unit Offline - Drive cannot be brought up or does not exist. 

Unit Available - Drive is not currently online. 

Data Error - Data on the disc is invalid. 
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Compare Host Data (continued) 

Controller Error - Controller has failed a self-test or internal 

consistency check. 
Drive Error - Drive error sensed by the controller. 
Compare Error - Disc data does not compare with data in memory. 

This is not a data error which states there is a problem 

with disc data. 
Host Buffer Access Error - Similar to nonexistent memory error in 

other systems. Occurs when a DMA cycle is attempted and a 

response was not received within a specified time period or 

a memory parity error was detected. 
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Determine Access Path 

Command and Response Description! This command is used in multi- 
port systems. When issued, the units online identify themselves to 
their connecting controllers. Controllers not online with the unit 
send Access Path Attention messages to their class drivers informing 
the drivers of the access paths to the unit. 



31 




COMMAND 
16 15 



00 





COMMAND REFE 


:rence 


NUMBER 


RESERVED 


UNIT NUMBER 

! 


MODIFIERS 


RSVD 


i OPCODE 
-I 



RESPONSE 



STATUS 



RSVD IENDC0DE 



Opcode: 13 (Octal), OB 
(Hex) 

Category; Sequential 

Allowable Modifiers: 

None 



Status 

Success (Normal) - 50% probability, or greater, that an Attention 

message was sent to notify other controller(s) of Access 

Path. 
Success (Duplicate Unit Number) - Controller recognizes the same 

unit number on more than one drive. 
Command Aborted - Controller succeeded in aborting the command. 
Unit Offline - Drive cannot be brought up or does not exist. 
Unit Available - Drive is not currently online. 
Controller Error - Controller has failed a self-test or internal 

consistency check. 
Drive Error - Drive error sensed by the controller. 
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Erase 
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over with zeroes. This command is similar to a Write command when the 
host zeroes a buffer, 

COMMAND 

31 16 15 00 
j . 1 , 

I COMMAND REFERENCE NUMBER | 
J | j 

I RESERVED i UNIT NUMBER j 
| j j j 

MODIFIERS I RSVD {OPCODE | 
j | j 

! BYTE COUNT j 

S „ r 1 



\ 



RESERVED 
(UNDEFINED FOR RESPONSE) 



LOGICAL BLOCK NUMBER 

RESPONSE 
FIRST BAD BLOCK 



Opcode: 22 (Octal), 12 
(Hex) 

Category: Nonsequential 

Allowable Modifiers: 

Express Request - Re- 
quests controller to 
place the command 
ahead of other nonse- 
quential commands in 
the queue. 

Force Error - Sector 
written with error to 
indicate that the data 
integrity is question- 
able. 



STATUS i FLAGS {ENDCODE 



Status 

Success (Normal) - Data erased from disc. 

Success (Duplicate Unit Number) - Controller recognizes the same 
unit number on more than one drive. 

Invalid Command - Controller cannot process the command because 
some field in the command packet is invalid for the control- 
ler or that unit; for example, the logical block number may 
be too large. 

Command Aborted - Controller succeeded in aborting the command. 

Unit Offline - Drive cannot be brought up or does not exist. 

Unit Available - Drive is not currently online. 

Write Protected - Data did not erase. 

Controller Error - Controller has failed a self-test or internal 
consistency check. 

Drive Error - Drive error sensed bv the controller. 
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Get Command Status 

Command and Resoonse Descriptions This command is fo?* in-Pormin^ 
the host where, approximately, another command is in the controller's 
queue; that is, whether the command progressed in the queue or not. 
This command assures that another command will not remain in the queue 
indefinitely. The outstanding reference number is the command that 
the Get Command Status is monitoring in both the command and response 
messages, The command status in the End Message is the amount of 
processing to be completed on the command in question. If the command 
has been processed this field returns zeroes. 



31 



COMMAND 
16 15 



00 




COMMAND REFERENCE NUMBER ! 



RESERVED 
MODIFIERS 



UNIT NUMBER } 



RSVD i OPCODE ! 



OUTSTANDING REFERENCE NUMBER 



RESPONSE 

---------------------------- 1 

! OUTSTANDING REFERENCE NUMBER j 

COMMAND STATUS i 

• j 

, | — | j 

STATUS j FLAGS IENDC0DE \ 

■ ■■■ 

i | | .„ j 



Opcode: 02 (Octal and 
Hex) 

Category: Immediate 

Allowable Modifiers: 

None 



atatus 



Success (Normal) - This command always succeeds, 
turned if the outstanding command has not been found. 



Zeroes are re- 
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Get Unit Status 

Command sn^ R@ crv onse Desc^i^t^ oni This command from the host rs= 
quests the unit (drive) characteristics. The class driver checks the 
status and unit identifier fields to determine which of the fields are 
valid. In previous systems the concepts of sectors/track, tracks/ 
cylinder | and cylinders/drive were used. In this system f the concepts 
of blocks/track, tracks/group, groups/cylinder, and cylinders/drive 
are used. 




COMMAND 
16 15 



00 



COMMAND REFERENCE NUMBER 
j. 

it Jio till V fciU j 
| 

MODIFIERS I RSVD j OPCODE 



UNIT NUMBER 

— — i ----- — 



RESPONSE 



STATUS 



UNIT FLAGS 



FLAGS jENDCODE 



MULTI-UNIT CODE 



RESERVED 



UNIT IDENTIFIER 



MEDIA TYPE IDENTIFIER 



RESERVED 



GROUP SIZE 



TRACK SIZE 



RESERVED 



COPIES | RBNs } 



RCT SIZE 



SHADOW UNIT { 



I CYLINDER SIZE { 



Opcode: 03 (Octal and 
Hex) 

Category: Immediate 

Allowable Modifiers: 

Next Unit - Requests 
status of the next 
known unit greater 
than or equal to the 
one specified in the 
unit number field. 
The unit whose status 

fied in the unit num- 
ber field in the end 
message (in the re- 
sponse). Unit zero is 
returned if there is 
no known unit greater 
than or equal to the 
unit number requested. 



Status 



Success (Normal) - Drive online 

Unit Offline - Drive offline 

Unit Available - Drive is not currently online 

Controller Error - Drive offline 

Drive Error - Drive offline 
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Get Unit Status (continued) 

End Message Fields 

Multi-unit Code - This field is used in multi-unit systems. 
Unit Flags - The unit flags are as follows: 

Bit Octal Hex Description 

11 Compare reads 

1 2 2 Compare writes 
7 200 80 Removable media 

13 20000 2000 Hardware write protect 

12 10000 1000 Software write protect 

Unit Identifier - The identifier is as follows: 

31 24 23 16 15 00 
| j 1 1 

i UNIQUE DEVICE NUMBER j 



i CLASS i MODEL j 



Unique Device Number - Identifies the device in the class and 
model categories. May be the unit's serial number. 

Model - A number identifying the particular model of this unit. 

Class - The class category would be 2 (decimal) for disc class 
devices. 

Media Type Identifier - The format is as follows: 

31 27 26 22 21 17 16 12 11 07 06 00 



DO ! D1 ! A0 I A1 { A2 | N i 



BITS DESCRIPTION 

00-06 N - Value of two decimal digits 

07-11 A2 - Alpha character left justified, A=1, B=2, 

C=3, .... Zero represents no character 
12-16 A1 - Alpha character left justified, A=1, B=2, 

C=3, . ... Zero represents no character 
17-21 A0 - Alpha character left justified, A=1, B=2, 

C=3, .... Zero represents no character 
22-26 D1 - Alpha character left justified, A=1, B=2, 

C=3, .... Zero represents no character 

C=3, .... Zero represents no character 
An example of DU RA80 is Hex 564,1050. 
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Get Unit Status (continued) 



Shadow Unit - If different from the unit number field, this unit keeps 
an online backup copy of the disc; a copy of the unit it is shadowing. 

Track Size - The value in this field is the number of logical blocks 
that exist within a logical track. "Logical" does not necessarily 
mean physical characteristics of the disc; for example, the RA80 has 
33 physical sectors in a physical track. Thirty-two of these sectors 
are host read/write, and one is a replacement sector for media 
problems. Therefore, there are 32 logical sectors, or blocks, in one 
track. On another manufacturer's drive, a different number of 
replacement blocks may produce a more optimum emulation, but the 
controller must inform the host of these logical divisions. The 
number of sectors is limited to the size of the field (16 bits). 

Group Size - The value in this field is the number of tracks in a 
group. 

The objective of using groups is to minimize the time it takes to 
access adjacent cylinders. This is accomplished by offsetting the 
starting sector of successive groups by an amount just greater than 
the time it takes to do the one cylinder seek; for example, one-half 
revolution of the disc may occur between the last sector of group 
and the first sector of group 1 . In other words, half the sectors per 
track may pass before head switching is complete. 

Cylinder Size - The value in this field is the number of groups in a 
cylinder. If the value is one, the cylinder size is the same size as 
the group size; in other words, groups and cylinders are the same. 

RCT Size - This field specifies the number of sectors available in the 
Replacement And Caching Table (RCT), which is at the end of the disc. 
This table describes the sectors replaced and information and data on 
the sectors being replaced. 

RBN - This field is the number of replacement blocks per track. 

Copies - This field is the number of copies of the RCT on the unit. 
The RA80, for example, has three full copies and a truncated copy. 
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Online 
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unit online and obtains and sets applicable unit characteristics. The 
End Message is the same format as the Set Unit Characteristics com- 
mand. Unit flags are described in "Control Message Formats Command 
and Response." Device dependent parameters are tuning parameters. 
Zero in this field indicates normal tuning parameters. 



31 



v.: 



COMMAND 
16 15 



00 



i COMMAND REFERENCE NUMBER 

| __ J 

I RESERVED i UNIT NUMBER 



MODIFIERS ,» RSVD | OPCODE 



UNIT FLAGS 



RESERVED 



RESERVED 



RESERVED 



DEVICE DEPENDENT PARAMETERS 



RESERVED 



RESERVED 



Opcode: 11 (Octal), 9 
(Hex) 

Category: Sequential 

Allowable Modifiers: 

Enable Set Write Pro- 
tect - Sets software 
Write Protect flag. 



RESPONSE 



STATUS 


i FLAGS jENDCODE 


UNIT FLAGS 


i MULTI-UNIT FLAGS 
i 


RESERVED 


UNIT 


IDENTIFIER 


MEDIA TYPE IDENTIFIER 


RESERVED 


i RESERVED 


UNIT SIZE 


VOLUME 


SERIAL NUMBER 
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Online (continued) 



Status 

Success (Normal) - Unit brought online. 

Success (Already Online) - If already online, the controller sets 
the flag bit. 

Invalid Command (Invalid Unit Flags) - If the unit is already 
online, host selectable unit flags remain the same. 

Command Aborted - The unit's online status does not change. The 
returned unit characteristics are invalid. 

Unit Offline - Unit is offline and cannot be brought online. 

Media Format Error - The unit is not properly formatted and 
therefore cannot be brought online. 

Controller Error - The controller has failed a self-test or in- 
ternal consistency check. 

Drive Error - Drive is not currently online. 

End Message Fields 

Multi-Unit Code - This field is used in multi-unit systems. The 
unit may have different characteristics such as removable/ 
fixed discs. 

Unit Flags - The unit flags are as follows: 



Bit 



Octal 



Hex 






1 


1 


1 


2 


2 


7 


200 


80 


13 


20000 


2000 


12 


10000 


1000 



Description 



Compare reads 
Compare writes 
Removable media 
Hardware write protect 
Software write protect 



Unit Identifier - The identifier is as follows; 



31 24 23 16 15 00 
{ j j 

I UNIQUE DEVICE NUMBER 

I I i 

i CLASS I MODEL i 
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Online (continued) 



Unique Device Number - Identifies the device in the class 
and model categories. May be a serial number. 

Model - A number identifying the particular model of this 



Class - The class category is 2 (decimal) for disc class 
devices. 



Media Type Identifier - The format is as follows: 



31 27 26 22 21 17 16 12 11 07 06 



00 



DO ! D1 I A0 j A1 I A2 i N 



BITS 

00-06 
07-11 

12-16 

17-21 

22-26 

27-31 



DESCRIPTION 

fij _ Value of two decimal digits 

A2 - Alpha character left justified, A=1 , 

C=3> .... Zero represents no character 
A1 - Alpha character left justified, A=1 , 

C=3 f .... Zero represents no character 
A0 - Alpha character left justified, A=1, 

C=3, .... Zero represents no character 
D1 - Alpha character left justified, A=1, 

C=3, .... Zero represents no character 
DO - Alpha character left justified, A=1, 

C=3, •••• Zero represents no character 



B=2, 
B=2, 
B=2, 
3=2, 
B=2, 



An example of DU RA80 is Hex 564,1050. 



Unit Size - This field specifies the number of logical blocks in 
the host area (without bad blocks). The first block of the RCT 
is equal to this value. 

Volume Serial Number - Zero if the volume serial number is not 
implemented, and undefined if the unit is offline. Except for 
zero, the number is generally a 10-digit decimal number with 
zero-left- justified. 
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Read 






TU, 






US US £ i "wi 



the disc and transfers the data to the host by DMA, If the Compare 
modifier is used, the data is read and compared with the second read 
to memory. The byte count is the number of bytes transferred success- 
fully. 



COMMAND 
16 15 



00 



COMMAND REFERENCE NUMBER 



RESERVED 



MODIFIERS 



UNIT NUMBER 



RSVD j OPCODE 



BYTE COUNT 



I BUFFER DESCRIPTION 
S (UNDEFINED FOR RESPONSE 



LOGICAL BLOCK NUMBER 




RESPONSE 
FIRST BAD BLOCK 



STATUS 



j FLAGS IENDC0DE j 



Opcode: 41 (Octal), 21 
(Hex) 

Allowable Modifiers: 

Compare - The control- 
ler reads the data 
twice — once into mem- 
ory. 

Express Request - Re- 
quest this command be 
put at the head of the 
Nonsequential queue. 

Suppress Error Correc- 
tion - Does not cor- 
rect errors but allows 
retries. 

Suppress Error Recov- 
ery - Requests that no 
steps be taken to re- 
cover data. 



K ! — 
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Read (continued) 



Status 



Success (Normal) - Data read successfully. 

Success (Duplicate Unit Number) = Controller recognizes the same 
unit number on more than one drive. 

Invalid Command - Controller cannot process the command because 
some field in the command packet is invalid for the control- 
ler or that unit; for example, the logical block number is 
too large. 

Command Aborted - Data not read as this command was aborted. 

Unit Offline - Data not read from unit. 

Unit Available - Data not read from unit. 

Compare Error - Data did not compare in the controller. 

Data Error - Data on the disc contains an error. 

Host Buffer Access Error - Similar to nonexistent memory in other 
systems. Occurs when a DMA cycle was attempted and a re- 
sponse was not received within a specified time period or a 
memory parity error was detected. 

Drive Error - Drive error sensed by the controller. 
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Replace 






f!nmma nti anH P ao r\^« o« n^ . . . _._ 

available replacement block and the bad block to the controller. The 
controller re-vectors the bad block (logical block number field) to 
the replacement block, and the host writes to the replacement block. 





ZOMMAND 

16 15 
i 



00 



COMMAND REFERENCE NUMBER 



RESERVED 



UNIT NUMBER 



MODIFIERS 



j RSVD j OPCODE 
REPLACEMENT BLOCK NUMBER 



RESERVED 



LOGICAL BLOCK NUMBER 
RESPONSE 



STATUS 



FLAGS 



Opcode: 24 (Octal), 14 
(Hex) 

Category: Nonsequential 

Allowable Modifiers: 

Express Request - Re- 
quests this command be 
put at the head of the 
Nonsequential queue. 

Primary Replacement 
Block - Requests the 
sector at the end of 
the track for replac- 
ing the bad sector. 



Status 



Success (Normal) - Bad block replaced. 

Success (Duplicate Unit Number) - Controller recognized the same 
unit number on more than one drive. 

Invalid Command - Controller cannot process the command because 
some field in the command packet is invalid for the control- 
ler or that unit; for example, the logical block number is 
too large. 

Command Aborted - Replacement command was aborted. 

Unit Offline - Drive was not ready. 

Unit Available - Drive was not online. 

Write Protected - The replacement block unit was write protected. 

Controller Error - The controller has failed a self-test or in- 
ternal consistency check. 

Drive Error - Drive error sensed by the controller. 
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Set Controller Characteristics 



C on? in and An^ rac r^n ^^ nae^^i nt'? c ?\ ? 






controller is brought online. The command identifies the host and 
controller versions of the emulation and time-outs. Host time-out 
default is 60 seconds. If the time-out set is 0, the controller does 
not time-out* Time and date are standard VAX/VMS format. 



31 



COMMAND 
16 15 



00 



COMMAND REFERENCE NUMBER 



RESERVED 
MODIFIERS 



RESERVED 

-——I 

RSVD j OPCODE 




CONTROLLER FLAGS | HOST VERSION 



V. 



RESERVED 



HOST TIME-OUT 



TIME AND DATE 



Opcode: 04 (Octal and 
Hex) 

Category: Immediate 

Allowable Modifiers: 

None 



RESPONSE 



STATUS 



I FLAGS IENDC0DE 



CONTROLLER FLAGS I CTRLR VERSION 



RESERVED i CTRLR TIME-OUT 



CONTROLLER IDENTIFIER 



Status 

Success (Normal) - Controller identified. 
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200 
100 


80 
40 


40 


20 


20 


10 



Set Controller Characteristics (continued) 

End Message Fields (continued) 

Controller Flags - The flags are as follows: 

Octal Hex Description 

Enable Attention Messages 

Enable Miscellaneous Error Log Mes- 
sages 

Enable other host's Error Log Mes- 
sages (multi-host controllers 
only) 

Enable this host's Error Log Mes- 
sages 

Controller Identifier - The identifier is as follows: 

131 24|23 16115 00{ 
j 1 | j 

i UNIQUE DEVICE NUMBER i 

j j__ i i 

I CLASS i MODEL | i 

j | | j 

Unique Device Number - Identifies the device in the class model 
category* May be the controller's serial number. 

Class - The class category is 1 for mass storage controllers. 

Model - A number identifying the particular model of this con- 
troller. 
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Set Unit Characteristics 



D c\a r\r\rt a a 
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— — . ^ M A _ — 



•f*r\y» 






those unit characteristics which the host is responsible for setting. 
The Command and End Message fields are the same as Online, but this 
command is for setting the characteristics after the unit is online. 
This command does not alter unit states of online, offline, or avail- 
able. If the status is Success or Unit Available, the unit identifier 
must not be zero. If the unit identifier is zero, the status is 
Offline and the characteristics are not valid. 




COMMAND 

31 16 15 00 
1 - 

COMMAND REFERENCE NUMBER 

RESERVED ! UNIT NUMBER 
| J 

MODIFIERS j RSVD | OPCODE 
| | 

UNIT FLAGS i RESERVED 
~ [ 

RESERVED 
RESERVED 

DEVICE DEPENDENT PARAMETERS 

RESERVED i RESERVED 
1 

RESPONSE 
| j 

STATUS | FLAGS IENDCODE 
1 j 

UNIT FLAGS jMULTI-UNIT FLAGS 
J 

RESERVED 

UNIT IDENTIFIER 

MEDIA TYPE IDENTIFIER 
1 

RESERVED ! RESERVED 
1 

UNIT SIZE 
VOLUME SERIAL NUMBER 



Opcode: 12 (Octal), A 
(Hex) 

Category: Sequential 

Allowable Modifiers: 

Enable Set Write Pro- 
tect - Sets software 
Write Protect flag. 
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Set Unit Characteristics (continued) 



Status 

Success (Normal) - Unit characteristics set. 

Invalid Command (Invalid Unit Flags) - If the unit is already 
online, host selectable unit flags remain the same. 

Command Aborted - The unit's online status does not change. The 
returned unit characteristics are invalid. 

Unit Offline - Unit is offline. 

Media Format Error - The unit is not properly formatted and 
therefore cannot be brought online. 

Controller Error - The controller has failed a self-test or in- 
ternal consistency check. 

Drive Error - Drive is not currently online. 

End Message Fields 

Multi-Unit Code - This field is used in multi-unit systems. The 
unit may have different characteristics, such as removable/ 
fixed discs. 



Unit Flags 
Bit 



The unit flags are as follows: 
Octal Hex Description 




1 
7 

• ./ 

12 



1 

2 

200 

20000 

10000 



1 

2 

80 

2000 

1000 



Compare reads 
Compare writes 
Removable media 
Hardware write protect 
Software write protect 



Unit Identifier - The identifier is as follows: 



31 24 23 16 15 00 
J 1 _ 

UNIQUE DEVICE NUMBER 
{ 1 

CLASS | MODEL i 
| | 
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Set Unit Characteristics (continued) 



Unique Device Number - Identifies the device in the class 
and model categories. May be this unit's serial number. 

Model - A number identifying the particular model of this 
unit. 

Class - The class category is 2 (decimal) for disc class 
devices. 

Media Type Identifier - The format is as follows: 

31 21 26 22 21 17 16 12 11 07 06 00 
J J j 1 1 1 1 

I DO ! D1 | A0 | A1 | A2 | N j 



BITS 

00-06 
07-11 

12-16 

17-21 

22-26 

27-31 



N 
A2 

A1 

A0 

D1 

DO 



DESCRIPTION 

Value of two decimal digits 

Alpha character left justified, A=1, 
C=3, .... Zero represents no character 

Alpha character left justified, A=1 , 
C=3, •••• Zero represents no character 

Alpha character left justified, A=1, 
C=3, .... Zero represents no character 

Alpha character left justified, A=1, 
C=3 > •••• Zero represents no character 

Alpha character left justified, A=1 , 
C=3, .... Zero represents no character 



B=2, 
B=2, 
B=2, 
B=2, 
B=2, 



An example of DU RA80 is Hex 564,1050. 



Unit Size - This field specifies the number of logical blocks in 
the host area (without bad blocks). The first block of the RCT 
is equal to this value. 

Volume Serial Number - Zero if the volume serial number is not 
implemented, and undefined if the unit is offline. Except for 
zero, the number is generally a 10-digit decimal number with 
zero-left- justified. 
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Write 
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host buffer and written to the disc. The fields in this command are 
the same as those in the Read command with the exception of Force Er- 
ror. The Force Error modifier is used deliberately to cause an error 

in a £»*>*" G»* 



COMMAND 
16 15 



00 



COMMAND REFERENCE NUMBER 
.— j 

RESERVED ! UNIT NUMBER 




MODIFIERS j RSVD j OPCODE 
j ,„ j 

BYTE COUNT 




BUFFER DESCRIPTION 
(UNDEFINED FOR RESPONSE) 



LOGICAL BLOCK NUMBER 

RESPONSE 
FIRST BAD BLOCK 



STATUS 



i FLAGS iENDCODE 



i 



Opcode: 41 (Octal), 21 
(Hex) 

Category: Nonsequential 

Allowable Modifiers: 

Compare - The control- 
ler reads the data 
twice — once into mem- 
ory. 

Express Request - Re- 
quest this command be 
put at the head of the 
Nonsequential queue. 

Force Error — Sector 
written with error to 
indicate that the data 
integrity is question- 
able. 

Suppress Error Correc- 
tion - Does not cor- 
rect errors but allows 
retries. 

Suppress Error Recov- 
ery - Requests that no 
steps be taken to re- 
cover data. 
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Write (continued) 



Status 



Success (Normal) - Data written successfully. 

Success (Duplicate Unit Number) - Controller recognizes the same 
unit number on more than one drive. 

Invalid Command - Controller cannot process the command because 
some field in the command packet is invalid for the control- 
ler or that unit; for example, the logical block number is 
too large. 

Command Aborted - Data not written as this command was aborted. 

Unit Offline - Data not written from unit. 

Unit Available - Data not written from unit. 

Write Protected - The replacement block unit was write protected. 

Compare Error - Data did not compare in the controller. 

Data Error - Data on the disc contains an error. 

Host Buffer Access Error - Similar to nonexistent memory in other 
systems. Occurs when a DMA cycle was attempted and a re- 
sponse was not received within a specified time period or a 
memory parity error was detected. 

Drive Error - Drive error sensed by the controller. 
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Access Path Attention Message 









.,„ ^A 4 ~ 
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port systems, causes this attention message. The message is sent to 
the host connected to the alternate port's controller. The format is 
as follows: 



31 



16 15 



00 



RESERVED 



RESERVED 



UNIT NUMBER 



RESERVED 



RSVD IATNC0DE 



Unit Number: The unit to which an access path is reported. 
Attention Code: 102 (Octal), 42 (Hex). 
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Available Attention Message 



Description: This message is transmitted by a controller any 
time a drive becomes available to a controller. The format is as 
follows: 



31 



16 15 



00 



RESERVED 



RESERVED 



UNIT NUMBER 



RESERVED I RSVD IATNC0DE 
, , ... 

UNIT FLAGS j MULTI-UNIT CODE 
UNDEFINED 



UNIT IDENTIFIER 



MEDIA TYPE IDENTIFIER 



X> 



TO 16 BYTES 
OF UNDEFINED DATA 



T" 



Unit Number - The unit being reported available. 

Attention Code - 100 (Octal), 40 (Hex). 

Multi-Unit Code - This field is used in multi-unit systems. the 

unit may have different characteristics, such as removable/ 

fixed discs. 
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Available Attention Message (continued) 



Unit Flags - The unit flags are as follows: 

.Octal Jiej[ Description 





1 

7 

13 

12 



2 

200 

20000 

10000 



1 

2 

80 

2000 

1000 



Compare reads 
Compare writes 
Removable media 
Hardware write protect 
Software write protect 



Unit Identifier - The identifier is as follows: 

31 24 23 16 15 00 

.| 1 

UNIQUE DEVICE NUMBER 




unique Device Number - Identifies the device in the class and 
model categories. May be this unit's serial number. 

Model - A number identifying the particular model of this 
unit. 

Class — The class category is 2 (decimal) for disc class 
devices. 

Media Type Identifier - The format is as follows: 



31 27 26 22 21 17 16 12 11 07 06 



00 



DO 



D1 



A0 



A1 



A2 



N 



J3X15 



DESCRIPTION 



00-06 
07-11 

12-16 

17-21 

22-26 

27-31 



N - Value of two decimal digits 

A2 - Alpha character left justified, A=1 



c=3, 
A1 - Alpha 

C=3, . 
A0 - Alpha 

C=3, . 
D1 - Alpha 

C=3, . 
DO - Alpha 

C=3. . 



.. Zero represents no character 

character left justified, A=1 

,. Zero represents no character 

character left justified, A=1 

.. Zero represents no character 

character left justified, A=1 

.. Zero represents no character 

character left justified, A=1 

, s Zero reoresents no character 



An example of DU RA80 is Hex 564,1050. 



B=2, 
B=2, 
B=2, 
B=2, 
B=2, 
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Dupicate Unit Number Attention Message 
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host that the same unit number appears on more than one drive. The 
host can then notify the operator to change the unit number. The host 
uses the Get Unit Status command with the next unit modifier to detect 
duplicates. Subsequent duplicates will be reported with this message. 
The format is as follows: 



31 



16 15 
1„. 

RESERVED 



00 



RESERVED 
RESERVED 



UNIT NUMBER 



RSVD IATNC0DE 



Unit Number - The number used for more than one unit. 
Attention Code - 101 (Octal), 41 (Hex). 
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